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About this guide 



This guide provides information to help you transition from earlier versions of HP StorageWorks 
High Availability Fabric Manager (HAFM) to HAFM 8.6. 

Intended audience 

This book is intended for use by system administrators and service technicians who are experienced 
with the following: 

• Fibre Channel technology. 

• StorageWorks Fibre Channel switches by Hewlett-Packard. 

Related documentation 

For a list of corresponding documentation included with this product, see the Related Documents 
section of the HP StorageWorks Release Notes. 

For the latest information, documentation, and firmware releases, please visit the HP StorageWorks 
web site: 

http://h1 8006.wwwl .hp.com/storage/saninfrastructure.html 

For information about Fibre Channel standards, visit the Fibre Channel Industry Association web 
site, located at http://www.fibrechannel.org . 

These and other HP documents can be found on the HP documents web site: 

http:/ / www.docs.hp.com . 
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Document conventions and symbols 



Table 1 Document conventions 



Convention 


Element 


Medium blue text: Figure 1 


Cross-reference links and e-mail addresses 


Medium blue, underlined text 

I httn" / /www hn rnml 


Web site addresses 


Bold font 


• Kpv nnmp^ 

I \c y 1 1 \A 1 1 1 

• Text typed into a GUI element, such as into a box 

• GUI elements that are clicked or selected, such as menu and 
list items, buttons, and check boxes 


Italics font 


Text emphasis 


Monospace font 


• File and directory names 

• System output 

• Code 

• Tpyt t\/npH nt thp rnmmnnn- inp 

1 CA 1 IV \A 1 1 1 1 O > v/ 1 1 1 1 1 1 — 1 1 I \jl I I I I c 


Monospace, italic font 


• Code variables 

• Command-line variables 


Monospace, bold font 


Emphasis of file and directory names, system output, code, and 
text typed at the command line 



A WARNING! Indicates that failure to follow directions could result in bodily harm or death. 



A CAUTION: Indicates that failure to follow directions could result in damage to equipment or data. 



|^ IMPORTANT: Provides clarifying information or specific instructions. 



[if NOTE: Provides additional information. 
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# TIP: Provides helpful hints and shortcuts. 



Rack stability 



A WARNING! To reduce the risk of personal injury or damage to equipment: 

• Extend leveling jacks to the floor. 

• Ensure that the full weight of the rack rests on the leveling jacks. 

• Install stabilizing feet on the rack. 

In multiple-rack installations, secure racks together. 

• Extend only one rack component at a time. Racks may become unstable if more than one 
component is extended. 



HP technical support 

Telephone numbers for worldwide technical support are listed on the HP support web site: 

http://www.hp.com/support/ . 

Collect the following information before calling: 

• Technical support registration number (if applicable) 

• Product serial numbers 

• Product model names and numbers 

• Applicable error messages 

' Operating system type and revision level 

• Detailed, specific questions 

For continuous quality improvement, calls may be recorded or monitored. 

HP strongly recommends that customers sign up online using the Subscriber's choice web site at 

http:/ / www.hp.com/ go/e-updates . 

• Subscribing to this service provides you with e-mail updates on the latest product 
enhancements, newest versions of drivers, and firmware documentation updates as well as 
instant access to numerous other product resources. 

• After signing up, you can quickly locate your products by selecting Business support and then 
Storage under Product Category. 

HP-authorized reseller 

For the name of your nearest HP-authorized reseller: 

In the United States, call 1-800-345-1518. 

• Elsewhere, visit the HP web site: http://www.hp.com . Then click Contact HP to find locations 
and telephone numbers. 
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Helpful web sites 

For third-party product information, see the following HP web sites: 

• http:/ / www.hp.com 

• http:/ / www.hp.com/ go/ storage 

• http://www.hp.com/support/ 

• http://www.docs.hp.com 
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1 Upgrading to HAFM 8.x 



This chapter provides instructions and considerations for upgrading software and migrating data 
from HAFM 6.x or 7.x to HAFM 8.x. Information is also included on configuration tasks that you 
should perform after upgrading. 

This chapter includes: 

• HAFM platform, page 1 1 

• HAFM 8 features, page 1 2 

• Remote client system requirements, page 14 

• Upgrading considerations, page 16 

• Upgrading and migrating procedures, page 17 

• Migrating data after initializing HAFM 8.x, page 23 

• Data migrated, page 24 

• Post-upgrading configuration tasks, page 26 

• Reverting to HAFM 8.2, page 27 

• Product license and feature keys, page 27 



HP StorageWorks High Availability Fabric Manager (HAFM) 8.x is supported only on the 1 U-high 
rack-mount HAFM appliance. Due to memory and other limitations of previous notebook server 
platforms, you cannot install HAFM 8.x on a notebook sever. The HAFM appliance is required for 
release 8.x and all future HAFM releases. 

The HAFM appliance and related applications provide a GUI to monitor and manage HP products. 
The HAFM appliance is a dedicated hardware and software solution that should not be used for 
other tasks. HP tests the HAFM application installed on the HAFM appliance, but does not test for 
compatibility with other, third-party software. 



A CAUTION: Modifications to the HAFM appliance hardware or installation of additional software 
(including patches or service packs) may interfere with normal operation. 



Figure 1 shows the 1 U-high rack-mount HAFM appliance. 



HAFM platform 




Figure 1 1 U-high rack-mount HAFM appliance 
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HAFM 8 features 



HAFM 8.x is based on a new software architecture that provides many improvements over HAFM 
7.x and prior versions. The new architecture provides increased flexibility and optional functions, in 
addition to preserving all the features that you have found valuable for monitoring and managing 
switches, directors, and fabrics in a storage area network (SAN). 

Key highlights 

Some key highlights of HAFM 8.x include: 

• All the functionality of the previous HAFM versions, which includes the HP Element 
Managers— previously called "Product Managers." 

• Significant user interface enhancements, along with more flexibility and control for users and 
administrators. 

• A modular architecture that allows new optional functions and enhancements. 

HAFM enhancements 

Some of the enhancements that you notice in this version compared to previous HAFM versions are: 

Redesigned User Interface— Provides a much cleaner look and feel. Also contains easier navigation 
features and fewer dialog boxes. 

Improved Zoning Interface— Zones and zone sets are created and other zoning functions are 
performed in one dialog box. 

Improved Import and Export Functions— You can import and export SAN information to disk and to 
an E-mail address. 

Centralized Product List— Provides a single list where you can view firmware levels, serial numbers, 
product properties and modify nicknames. You can export the Product List in tab-delimited format. 
To view an exported Product List in table format, open it in E-mail Excel. 

Nicknames— Exports the product nicknames along with their world wide names (WWNs). 

Preferred Path Support— Feature provided through the Element Manager that allows you to a define 
preferred path through a fabric between two attached devices. 

For more detailed information on the differences between HAFM 7.x and HAFM 8.x, see 
"Comparing HAFM 7.x and 8.x feature locations" on page 31 . 

Important notes 

Be aware of the following: 

• You should not use more than one copy of HAFM to monitor and manage the same devices in a 
subnet. Loss of HAFM functions, panic reboots from devices, and other problems may result. 

• Running HAFM 8.x and earlier versions of HAFM concurrently is not recommended. Results 
could be unpredictable and undesirable. 

Upgrade scenarios 

This guide provides information on upgrading HAFM software for the following situations: 
12 Upgrading to HAFM 8.x 



• "Upgrading from HAFM 7.x to 8.6" on page 1 7 

• "Upgrading from HAFM 8.2 to 8.6" on page 20 

• "Replacing notebook server with HAFM appliance" on page 21 

Feature details 

This section provides details about HAFM 8.x standard and optional features. 

Standard features 

Following are descriptions of some of the standard enhanced base features: 

Role-Based Access Control— Allows you to define specific user types and assign rights to those 
types. This allows better management of administrative workloads by assigning responsibilities and 
areas of management to specific administrators and users. 

User-Defined Groups and Views— Ability to create customized views by grouping and labeling 
managed elements based on specific environments and user needs. This provides better use of 
screen real-estate for managing large and multiple fabrics. 

Reports— Ability to generate and export reports. You can generate the following reports: 

• Product List— Lists the Product List, which has detailed information about the products in the 
SAN. 

• Operating Status Change— Lists status change for products in the SAN, including the number of 
products online and offline, the product with the most downtime, and details about each 
product's status. 

• Physical Map— Displays a graphic of the SAN's topology. 

• Port Usage— Lists the number of used ports in the SAN as well as detailed usage information for 
each port. 

• Fabric Ports— Lists fabric details, including port and director utilization and individual product 

Improved Import and Export Functions— You can import and export SAN information to disk and to 
an E-mail address. The exported files include SAN Files, Physical Map, Product List, reports, 
Nicknames, XML topology, and status. The Physical Map can be exported to a . gif file. 

Greater Scalability— Ability to manage a greater number of fabric ports and switching devices. This 
also allows HAFM appliance consolidation in many cases as well as the ability to manage more 
and larger fabrics. 

Master Log— This displays on the HAFM desktop. It contains information on all events that have 
occurred on the SAN including the event type, description, time of occurrence, IP address of where 
event occurred, node and port name where event occurred, and level of severity. 

SNMP Agent— The simple network management protocol (SNMP) agent instruments the objects 
defined in the Fibre Channel Management (FCMGMT) Management Information Base (MIB) Version 
3.1 and a small number of objects defined in MIB II. Through instrumentation of these MIB objects, 
the agent acts as a translator of information stored on the HAFM appliance into a form usable by 
SNMP management stations. Using HAFM dialog boxes, you can configure network addresses and 
community names for up to 12 SNMP trap recipients, which receive messages through SNMP for 
specific events that occur on the HAFM appliance. 
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Future Enhancements— Ability to add on new optional features and software modules. 
Optional features 

Following are descriptions of optional features that require purchase of a license key. 

Event Management— Ability to define and monitor specific conditions and events within the fabric, 
and then trigger actions, such as reports, E-mail, data export, logs, messages, and sound. This can 
help automate routine tasks and reduce the amount of manual intervention necessary to manage the 
SAN. 

Performance Monitoring— Ability to measure and graphically display performance statistics, historic 
data and future trends of every switch port on your SAN. This allows you to pinpoint areas of 
over-utilization and under-utilized ports and identify trends and problem areas. 

SAN Planning— This feature allows you to evaluate the effects of a new device deployment or plan 
for a completely new storage network using a set of best-practice configuration rules. This can 
enable you to design a scalable, cost-effective storage network for specific requirements. 

Remote client system requirements 

You can install HAFM client software on remote computers and log into the HAFM appliance to 
control and monitor SAN components. Verify that remote systems where you install the client 
software meet the following minimum requirements: 



Table 2 Windows system requirements for remote client 



Item 


Requirement 


Processor 


1 GHz Intel Pentium III and up 


Hardware 


CD-ROM 


Operating System 


• Windows 2000 Professional with service 
pack 3 or above 

• Windows 2003 


Memory 


1 GB RAM (minimum) 


Disk Space 


350 MB disk space 


Video Requirements 


8 MB Video RAM 


Resolution 


256 colors 
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Table 3 Solaris system requirements for remote client 



Itotn 


Roninramont 


/vioaeis 


1 114" r/i 1 1 1 /i n /-i i i f~\ 

uiira i u ana up 


processor 


uiiraoparc in or greaier 


nuiu WU 1 t2 


CD POM 


wperuTiny oysTem 


ooians o or y 


A A arn nr\f 

f v it? 1 1 1 w i y 


SI 9 MR RAM fminimnml 

*J 1 ^ /VID IXAA/Vl ^1 1 II 1 II 1 1 1 Ul 1 1) 


Disk Space 


350 MB disk space 


Video Requirements 


8 MB Video RAM 


Resolution 


256 colors 


Table 4 LINUX system requirements for remote client 


Item 


Requirement 


Processor 


1 GHz Intel Pentium III and up 


Hardware 


CD-ROM 


Operating System 


• Red Hat Enterprise LINUX ES 3.0 

• Red Hat 8.0 kernel v.2.4.20-8 

• Red Hat 9.0 kernel v.2.4. 18-14 


Memory 


512 MB RAM (minimum) 


Disk Space 


350 MB disk space 


Video Requirements 


8 MB Video RAM 


Resolution 


256 colors 


Table 5 HP-UX system requirements for remote client 


Item 


Requirement 


Models 


9000/785/B2000 models 


Processor 


400 MHz PA-RISC 


Hardware 


CD-ROM 


Operating System 


HP-UX version 1 1 .0 or greater 


Memory 


512 MB RAM (minimum) 


Disk Space 


350 MB disk space 


Video Requirements 


HP VISUALIZE-FXE color, 1 280x1 024 48 
planes 


Resolution 


256 colors 
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Table 6 AIX system requirements for remote client 
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256 colors 



Upgrading considerations 

The following considerations apply when upgrading to this release: 

• You cannot install the HAFM 8.x package on an existing notebook server due to memory and 
other limitations. 

• You can only upgrade an HAFM appliance running HAFM 7.02.00 or greater to HAFM 8.x. 

• After installing HAFM 8.x on an HAFM appliance all remote clients running down-level versions 
of the HAFM are required to re-install the client application. 

• Once the HAFM appliance is upgraded to HAFM 8.x, any downgrade of HAFM to a previous 
release result in the loss of saved firmware files. 

• When migrating data from a notebook server to an HAFM appliance that is running HAFM 8.x, 
you can migrate data from the notebook server as a mapped (shared) drive. Both the notebook 
server and HAFM appliance must be on the same physical network. This may require additional 
hardware such as a hub or switch if an unused Ethernet port is not available. 

Exit all HAFM software running on the HAFM appliance and remote systems before upgrading. 
HAFM Services must be stopped on the appliance. 

• The previous HAFM 7.x version is not removed from an existing HAFM appliance during the 
HAFM 8.x upgrade process. After installing HAFM 8.x, you must uninstall the previous HAFM 
7.x version before rebooting, because HAFM services for both versions start after reboot. Current 
HAFM data is not removed, however, and is available for migration to the new HAFM version. 

• On failure of migration of any resource (switch) data, the migration continues. There is no 
recovery from a switch being unavailable before the start of migration other than running the 
install again. 

• When upgrading a notebook server to an HAFM appliance running HAFM 8.x, or upgrading 
an HAFM appliance to HAFM 8.x from an earlier version, make sure that you obtain the serial 
number (on the software CD jewel case) and your license key for your installation. Refer to 
"Product license and feature keys" on page 27 for general information on license and feature 
keys. 

• You must have System Administrator user rights for earlier versions of HAFM. Obtain a login ID 
and password with those rights. 
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• The notebook server must be at version HAFM 6.0 or greater before you can migrate data to an 
HAFM appliance running HAFM 8.x. If not at release 6.0 or greater, upgrade to HAFM 7.1 or 
greater. Refer to upgrade instructions for the HAFM to which you are upgrading. 



|?f NOTE: The HAFM software must be version 7.01 .00 or later to upgrade firmware on supported 
directors and switches to version 05.01 .00 or later. If not, then you must upgrade the HAFM 
software to at least 7.01 .00. For upgrade procedures, refer to the "Managing Firmware Versions" 
section in the service manual for your switch and director. 



• The firmware on switches and directors managed by HAFM 8.x must be at version 4.0 or 
greater. However, if you want HAFM management and administrative support for features in 
firmware 6.0, you should upgrade switches to that version. 

Upgrading and migrating procedures 

This section describes upgrade/mig ration procedures for the following situations: 

• Upgrading an existing HAFM appliance to HAFM 8.x. 

• Replacing a notebook server running HAFM 7.x or 6.x with an HAFM appliance running HAFM 
8.x. 

Upgrading from HAFM 7.x to 8.6 

This section includes procedures to upgrade HAFM 7.x to HAFM 8.6 on the 1 U-high rack mount 
HAFM appliance. 



A NOTE: Be sure to keep the current version of your software. If you need to restore version 8.6 in the 
future, you need to reinstall your current version before installing version 8.6 in order to ensure that 
the backup functionality functions correctly. For more information, refer to the HP StorageWorks 
HA-Fabhc Manager user guide. 



Before upgrading 

Before beginning the upgrade procedure, complete the following tasks: 

1. Read the "Upgrading considerations" on page 16. 

2. Get the license key listed as instructed on the entitlement request certificate that shipped with the 
product. 

3. Make sure that you obtain the serial number (on the software CD jewel case) and your license 
key for your installation. Refer to "Product license and feature keys" on page 27 for more 
information. 

4. If you use Call Home through dial-out, double-click the Call Home Setup icon on the Windows 
desktop of the HAFM appliance, and copy phone numbers and other pertinent details from the 
Network and Dial-up Connections - CallHome.pbk dialog box Properties tab so that you can use 
them to configure the Call Home feature in the new release. For details, refer to the 

HP StorageWorks HA-Fabhc Manager user guide. 
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5. Fully back up HAFM data on your HAFM appliance. To do this, copy the c : \HafmData 
directory to the HAFM appliance CD-RW drive where backups occur. Overwrite the existing 
files. 

6. Leave the HAFM 7.x software running. Do not launch the HAFM 7.x client. 

7. On the HAFM 7.x machine, define a user with username of Administrator, a password of 
password, and with system administrator privilege. 

Upgrade procedure 

1. Insert the software installation CD provided with your HAFM upgrade kit into the CD-ROM drive. 
If autorun is enabled, the installer begins automatically. If it is not enabled open the 

<CD dri ve>\Windows\setup . exe file. 

The InstallShield wizard takes you through the installation process. 

2. When the Choose Destination Location dialog box displays, select the usual location for your 
system's application files (for example, c : \Program Files\HAFM 8 .x) and click Next. 
HAFM 8.x refers to the version. 

3. When the Start Menu Location dialog box appears, select a folder for HAFM icons and click 
Next. 

HAFM 8.x files install on your system. 

4. Click Finish. 

5. Open the application by double-clicking the HAFM desktop icon or by selecting 
Start > Programs > HP StorageWorks ha-fabric manager 8.6 > HAFM 8.6. 

The Configuration Wizard displays the first time you open the application. 

6. On the Welcome page, click Next. When the License Agreement screen displays, read the 
agreement and click Yes. 

7. Click Next. The Copy Data and Settings dialog box displays. 

8. Click No, and then click Next. The HAFM Server Name dialog box displays. 

9. Enter a name of fewer than 20 characters (blank spaces are acceptable) for the HAFM 
appliance. Click Next. The HAFM 8.x Server License dialog box displays. 

10. Enter your product's serial number and your license key. 

You are only required to enter a serial number and license key if you are upgrading to HAFM 
8.x from an earlier HAFM version on the HAFM appliance. Refer to "Product license and feature 
keys" on page 27 for more information. 

1 1. Click Next. A confirmation screen displays. 

12. Click Finish. 

13. When the HAFM 8.6 Log In dialog box displays, click Cancel. 
14. Stop HAFM services for HAFM 8.6 using the following steps: 

a. Select Start > Programs > HP StorageWorks ha-fabric manager 8.6 > Stop Services. A DOS 

window displays with messages of services being shut down. 

b. Press any key to close the window. 
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Migrating data to HAFM 8.6 

1. On the HAFM 8.6 machine, go to directory c : \Program Files\HAFM 8 . 6\bin and run 
program LegacyExportlmport.bat. Enter the following information: 

• IP address of the HAFM 7.x machine. If both software application reside on the same 
machine, enter 127 .0.0.1. 

• Install directory of the HAFM 7.x software. Default path is c : \Program Files\HAFM. 

• Data directory of the HAFM 7.x software. Default path is c : \hafmdata. 

• HAFM 7.x username and password. Enter Administrator and password. 

The migration starts and two logs are created in the data directory of the HAFM 8.6 install 
directory: SevenX_Export . log and SevenX_lmport . log. A confirmation message 
displays when the migration is finished. 

2. Stop HAFM services for HAFM 7.x using the following steps: 

a. Select Start > Programs > HP StorageWorks ha-fabric manager > Stop Services. A DOS 

window displays with messages of services being shut down. 

b. Press any key to close the window. 

3. Start HAFM services for HAFM 8.6 using the following steps: 

a. Select Start > Programs > HP StorageWorks ha-fabric manager > Start Services. A DOS 

window displays with messages of services being started. 

b. Press any key to close the window. 

4. When the HAFM 8.6 Log In dialog box displays, enter Administrator as the default user 
name and password as the password. 



Connect to HAFM 8.B server to open a SAN 



Network Address |localhost 
Server Name 



User ID l Administrator 
Password ******** 



O Forget password 
• Save password 



Login , Exit 



O Server Not Available 



Figure 2 HAFM 8.6 Login dialog box 



Hf NOTE: Once you log in, you can change the user ID and password for future logins. 

5. Click Login. 

6. Refer to Chapter 2, "Getting a license key for new software" in the HP StorageWorks HA-Fabric 
Manager user guide. 

7. Refer to Chapter 2, "Setting up the application" in your HP StorageWorks HA-Fabric Manager 
user guide for further instructions using the application. 
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8. After installing HAFM 8.6, if the previous HAFM 7.x version has not been uninstalled, you must 
uninstall it before rebooting. Otherwise HAFM services for both versions start after reboot. 

Upgrading from HAFM 8.2 to 8.6 

This section includes procedures to upgrade HAFM 8.2 to HAFM 8.6 on the 1 U-high rack mount 
HAFM appliance. 

Before upgrading 

Before beginning the upgrade procedure, complete the following tasks: 

1. Read the "Upgrading considerations" on page 16. 

2. Get the license key listed as instructed on the entitlement request certificate that shipped with the 
product. 

3. Make sure that you obtain the serial number (on the software CD jewel case) and your license 
key for your installation. Refer to "Product license and feature keys" on page 27 for more 
information. 

4. If you use Call Home through dial-out, double-click the Call Home Setup icon on the Windows 
desktop of the HAFM appliance, and copy phone numbers and other pertinent details from the 
Network and Dial-up Connections - CallHome.pbk dialog box Properties tab so that you can use 
them to configure the Call Home feature in the new release. For details, refer to the 

HP StorageWorks HA-Fabric Manager user guide. 

5. Fully back up HAFM data on your HAFM appliance. To do this, copy the c : \HafmData 
directory to the HAFM appliance CD-RW drive where backups occur. Overwrite the existing 
files. 

6. To avoid errors, close all instances of the application before upgrading. Shut down HAFM on the 
appliance and on all remote workstations. 

7. Stop HAFM services using the following steps: 

a. Select Start > Programs > HP StorageWorks ha-fabric manager > Stop Services. A DOS 

window displays with messages of services being shut down. 

b. Press any key to close the window. 
Upgrade procedure 

1. Insert the software installation CD provided with your HAFM upgrade kit into the CD-ROM drive. 
If autorun is enabled, the installer begins automatically. If it is not enabled open the 

<CD dri ve>\HAFM86_win\setup . exe file. 

The InstallShield wizard takes you through the installation process. 

2. When the Choose Destination Location dialog box displays, select the usual location for your 
system's application files (for example, c : \Program Files\HAFM 8 . 6) and click Next. The 
Start Menu Location dialog box displays. 

3. Select a folder for HAFM icons and click Next. 
HAFM 8.x files install on your system. 

4. Click Finish. 
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Migrating data to HAFM 8.6 

1. Stop HAFM services for HAFM 8.2 using the following steps: 

a. Select Start > Programs > HP StorageWorks ha-fabric manager 8.6 > Stop Services. A DOS 

window displays with messages of services being shut down. 

b. Press any key to close the window. 

2. Open the application by double-clicking the HAFM desktop icon or by selecting 
Start > Programs > HP StorageWorks ha-fabric manager 8.6 > HAFM 86. 

The Configuration Wizard displays the first time you open the application. 

3. On the Welcome page, click Next. When the License Agreement screen displays, read the 
agreement and click Yes. 

4. Click Next. The Copy Data and Settings dialog box displays. 

5. Click No, and then click Next. The HAFM Server Name dialog box displays. 

6. Enter a name of fewer than 20 characters (blank spaces are acceptable) for the HAFM 
appliance. Click Next. The HAFM 8.x Server License dialog box displays. 

7. Enter your product's serial number and your license key. 

You are only required to enter a serial number and license key if you are upgrading to HAFM 
8.x from an earlier HAFM version on the HAFM appliance. Refer to "Product license and feature 
keys" on page 27 for more information. 

8. Click Next. A confirmation screen displays. 

9. Click Finish. 

10. When the HAFM 8.6 Log In dialog box displays, click Cancel. 
1 1.Stop HAFM services for HAFM 8.6 using the following steps: 

a. Select Start > Programs > HP StorageWorks ha-fabric manager 8.6 > Stop Services. A DOS 

window displays with messages of services being shut down. 

b. Press any key to close the window. 

Replacing notebook server with HAFM appliance 

Use the following procedure to replace a notebook server running HAFM 6.x or 7.x with a 1 U-high 
rack-mount HAFM appliance running HAFM 8.x. 

Considerations 

Before replacing an HAFM notebook server with an HAFM appliance, consider the following: 

• These instructions assume that you have received an upgrade kit containing an HAFM appliance 
with HAFM 8.x installed. Instructions also assume that you have not already initialized the 
software on the new HAFM appliance by entering your license key and serial number. 



Hf NOTE: If you have not migrated data from the notebook server, but have already initialized the 
HAFM 8.x software on your HAFM appliance by entering your license key and serial number, 
follow steps in "Migrating data after initializing HAFM 8.x" on page 23. 
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• The notebook server must be at version HAFM 6.0 or greater to migrate data to the HAFM 
appliance running HAFM 8.x. 

• Both the notebook server and HAFM appliance must be on the same physical network. This may 
require additional hardware such as a hub or switch if an unused Ethernet port is not available. 

The HafmData directory and HAFM application directory must be on the same drive on the 
notebook server. Typically, these directories are c : \HafmData and c : \ Program 
Files \HAFM respectively. 

• You must share the root drive (typically c : \) of the notebook server and map this drive on the 
HAFM appliance. This drive can be shared as "read-only." You can then migrate data from the 
notebook server using the Copy Data and Settings dialog box in the configuration wizard by 
browsing to the mapped drive. 

Procedure 

Follow these steps: 

1. Make sure that you obtain the serial number (on the software CD jewel case) and your license 
key for your installation. Refer to "Product license and feature keys" on page 27 for more 
information. 

2. If the notebook server is not running HAFM 6.0 or later, upgrade the server using instructions 
provided with your HAFM 6.0 upgrade kit. 

3. Make sure the notebook and HAFM appliance are online and functioning. 

4. Fully back up HAFM data on your notebook and HAFM appliance. 

• Notebook server. Copy the c : \HafmData directory to your Zip disk where backups occur. 

• HAFM appliance. Copy the following directories to your CD-ROM drive, where 
<Install_Home> is the directory where HAFM is installed: 

< Ins t a 1 l_Home> \ C 1 i en t 
<lns t a 1 l_Home> \ S e r ver 
<lnstall_Home>\C&ll Home 

5. Share the root drive on your notebook server containing your HAFM data directory and HAFM 
application (typically c : \HafmData and c : \Program Files\HAFM). 



Hf NOTE: You may have to work with your system administrator to share your c : \ drive. 
Shared access can be read-only. 



a. Double-click the My Computer icon on your Windows desktop to open the My Computer 
window. 

b. Right-click Local Disk (c:) and select Sharing from the pop-up menu. 

c. Select Sharing > Share this folder. 

d. Use the default Shared Name. 

e. Click OK. A hand icon displays by the folder name in Windows Explorer or My Computer to 
indicate that the folder is shared. 

6. Map the shared c : \ drive on your HAFM appliance so that you can access files. 
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a. Right-click My Computer and select Map Network Drive from the pop-up menu. 

The Map Network Drive dialog box displays. The HAFM folder name, preceded by your 
server name (computer name) should be available in the Folder drop-down list. 

b. Select the appropriate folder (see step 5). 

c. Click Finish. 

7. Follow all instructions, beginning with step 5, in "Upgrade procedure" on page 20, to finish the 
upgrade. 

Migrating data after initializing HAFM 8.x 

If you did not migrate HAFM data from a notebook server when you initialized the HAFM 8.x 
application on the HAFM appliance (in other words, you did not select Yes from the Copy Data and 
Settings screen), you still have two options for migrating this data. 

Option 1 : reinstall HAFM application 

You can perform the following steps, depending on your upgrade situation: 
Upgrading existing HAFM appliance to HAFM 8.6 
Perform the steps for one of the following: 

• "Upgrading from HAFM 7.x to 8.6" on page 1 7. 

• "Upgrading from HAFM 8.2 to 8.6" on page 20 

Replacing notebook server with HAFM appliance 

Perform all steps in "Replacing notebook server with HAFM appliance" on page 21 . 

Option 2: using Doit command 

You can perform the following steps, depending on your upgrade situation: 
Upgrading HAFM appliance to HAFM 8.6 

1. After the HAFM 8.6 Log In dialog box displays while performing one of the following: 

• "Upgrading from HAFM 7.x to 8.6" on page 1 7 

• "Upgrading from HAFM 8.2 to 8.6" on page 20 

2. Perform all steps in the "Editing HAFM_co.bat file" on page 24. 

3. Continue with the step where you previously stopped in one of the following: 

• "Upgrading from HAFM 7.x to 8.6" on page 1 7 

• "Upgrading from HAFM 8.2 to 8.6" on page 20 

Replacing notebook server with HAFM appliance 

1. Make sure you have performed step 1 through step 6 in "Replacing notebook server with HAFM 
appliance" on page 21. 

2. Perform all steps in the "Editing HAFM_co.bat file" on page 24. 

3. Continue with step 7 in "Replacing notebook server with HAFM appliance" on page 21 . 
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Editing HAFM_co.bat file 



_f NOTE: Perform these steps on your HAFM appliance (if replacing the notebook server with the 
HAFM appliance). 



1. Shut down HAFM 8.6 by selecting Exit from the SAN menu. 

2. Right-click the HAFM 8.6 icon on your desktop and select Edit from the pop-up menu. 
The HAFM_co . bat file displays in your default editor (such as Notepad). 

3. At the very end of the line that starts with the following string, add a space, then the word doit. 

% JAVA_HOME% \bin\HAFMWi zard . exe <software_switch.es> doit 
The <software_switches> are a series of variables (switches). 

4. Save and close the hafm_co .bat file. 



Specific data is migrated when you select the Yes option from the Copy Data and Settings dialog 
box when you upgrade HAFM software on your HAFM appliance. The following explains the data 
that is migrated and not migrated. 



Data stored in the c : \HafmData directory is migrated to the comparable data directories on the 
new appliance running HAFM 8.x. This includes user information, E-mail event configuration, 
threshold alert configurations and zoning configurations. 

User information 

• User ID 

• Password (encrypted in MD5 format) 

• Username 

• User rights 

• System Administrator - transfers to HAFM 8.x as the System Administrator user group. 

• Product Administrator - transfers to HAFM 8.x as the Product Administrator user group. 

• Operator - transfers to HAFM 8.x as the Operator user group. 

• Maintenance - transfers to HAFM 8.x as the Maintenance user group. 

E-Mail event configuration 

All E-mail addresses entered in the HAFM 7.x Configure E-Mail dialog box migrate to the E-mail 
Event Notification Setup "User List" under one user. You have to modify the User List in HAFM 8.x to 
assign addresses to individual users. 

FAF libraries 

File access facility (FAF) library data is migrated. This includes all information from the Configure 
Address - "Active" dialog box (FICON management style only) in HAFM 7.x Product Manager. 
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Firmware library 

The Firmware Library is migrated in the upgrade process, but release rules are not. Since release 
rules are required, an error results when you attempt to send a firmware version in the library to a 
switch. To avoid this problem, add the latest firmware file to the firmware library. This also adds the 
new release rules and resolve the problem 

Logs 

HAFM audit, event, session, product status, and fabric log files are migrated to the same logs in 
HAFM 8.x. As a safeguard, you should export and archive these logs before migrating to HAFM 
8.x. 

Product Manager Audit, Event, Hardware, Link Incident, and Threshold Alerts are migrated. 

Nicknames 

Nicknames configured through the Configure Nicknames dialog box in HAFM are migrated. 

Sessions configuration 

Information from the Configure Sessions dialog box is migrated. This includes: 

• Network addresses of computers allowed or prohibited from remote sessions. 

• Maximum number of remote sessions allowed. 

SNMP configuration 

All data from the SNMP configuration is migrated. This includes the enable/disable flag and 1 2 
rows of trap information that are configured in the HAFM Configure SNMP dialog box. 

Switch identification 

All switches and directors identified in the HAFM 6.x or 7.x Products View are migrated into HAFM 
discovery and are placed in the Selected Individual Addresses table of the Discover Setup dialog 
box. These switches are managed by HAFM 8.x. Note that if addresses did not "completely" 
migrate, you can enter the IP address of the switch or director in that dialog box. 

Threshold alert configurations 

Data input through the Configure Threshold Alert wizard in the Product Manager is migrated. 
Zoning configurations 

Zones and zone sets are migrated to the default Zoning Library. 

Data not migrated 

The following types of information are not migrated: 

• Configurations for optional HAFM features, such as Open Trunking, SANtegrity Binding, 
Enterprise Management Mode, Persistent Fabrics, and FlexPort. You must obtain feature keys for 
these optional features to enable them. 

• Except for the firmware library, FAF files, and logs, other Product Manager data is not migrated 
since it is stored in switch memory for access by the Element Manager. 
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• Files created using the Backup and Restore Configuration option in the Product Managers 
(NVRAM backup). 

• Performance data from the Performance view in the Product Manager. 

• Configuration information for switches that are not being managed locally are not included in 
the migration. 

• -If the Administrator user's password was changed in the previous version of HAFM, the 
password is not migrated. Instead, it reverts to the default password [password). 

Post-upgrading configuration tasks 

After upgrading to HAFM 8.x, you should perform the following tasks. 

General HAFM configuration 

• User Configuration— Perform tasks in Chapter 3 entitled "Configuring an HAFM Appliance" and 
"Managing Users" in the HP StorageWorks HA-Fabric Manager user guide. Although user data 
from earlier HAFM versions is migrated, there are additional tasks that you must perform, such 
as configuring E-mail addresses and filtering event notifications. 

• Call-Home— To set up the call home feature, you first specify the support center information 
through the call home configuration (Call Home icon in the HAFM desktop). If you are 
upgrading from a previous release of the application, all of your call home settings are 
preserved. You must also enable call home notification through the Event Notification option 
under the Monitor menu. For details refer to the HP StorageWorks HA-Fabric Manager user 
guide. 

• Event Notification— This includes configuring E-mail and call home event notification. Refer to 

"Comparing HAFM 7.x and 8.x feature locations" on page 31 . 

Note that all E-mail addresses entered in the HAFM 6.x or 7.x Configure E-Mail dialog box 
migrates to the HAFM 8.x E-mail Notification Setup "User List" under one user. You have to 
modify the User List in HAFM 8.x to assign addresses to individual users. Refer to the 
HP StorageWorks HA-Fabric Manager user guide for instructions. 

• Configuring SAN Devices— Perform applicable procedures in the HP StorageWorks HA-Fabric 
Manager user guide. This includes steps for configuring Enterprise Fabric Mode (if installed), 
configuring fabric binding (if installed), and configuring trap forwarding. 

Upgrading remote clients 

To log into the HAFM appliance as a remote client and use HAFM 8.x, you must download the 
client application to your system. Supported operating systems include Windows, Solaris, HP-UX, 
AIX, and LINUX. 

To upgrade an HAFM client on a remote system, use the following procedure. 

1. Make sure that HAFM is not running on the remote machine. 

2. Open an Internet browser. 

3. Type the IP address of the HAFM appliance in the Location (or Address) box on the browser, 
then press Enter. 
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4. When the remote client installation screen displays, select the appropriate download for your 
operating system. 

5. Follow instructions in the configuration wizard to install the client to your system. 

6. To start the application: 

• On Windows systems, select the Start > Programs > HP HAFM > HAFM 8.x to open the 
application. 

• On Unix systems, enter. /HAFM_Client. 

Reverting to HAFM 8.2 

Following are instructions for reverting back from HAFM 8.6 to HAFM 8.2 on the HAFM appliance. 

7. Remove HAFM 8.6 using the following steps. 

a. Select Start > Programs > HP StorageWorks ha-fabric manager 8.6 > Uninstall. 

Follow the uninstall directions. 
Or 

If you do not want to remove HAFM 8.6 at this time, you must reconfigure HAFM 8.6 Services to 
start manually instead of automatically. You cannot run HAFM 8.6 and earlier HAFM Services at 
the same time when the HAFM appliance is rebooted. To do this: 

a. Make sure that HAFM 8.6 is running. 

b. Select Start > Settings > Control Panel. 

c. Select Administrative Tools. 

d. Select the Services. The Services dialog box displays. 

e. Double click each of the following services, one at a time, to display a Properties dialog box. 
Change the Startup type to Manual using the drop-down list and click OK. 

• HAFM 8.6 Backup 

• HAFM 8.6 Call Home 

• HAFM 8.6 

8. Start process from HAFM 8.2 Install home. Execute the callhome.bat, backup.bat, and 
install_service.bat files from the \install directory\bin directory. 

9. Start the HAFM Services (make sure that HAFM 8.6 is running). 

10. Launch the HAFM client and log on to the HAFM appliance. 



A CAUTION: Once the HAFM appliance is upgraded to release HAFM 8.x, any downgrade of 
HAFM to a previous release results in the loss of saved firmware files. 



Product license and feature keys 

License keys are unique strings of alphanumeric characters that verify ownership of HAFM software 
and additional software modules that you can purchase. 
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Feature keys are unique strings of alphanumeric characters that verify ownership of an Element 
Manager application for a specific switch and the additional features that you purchase for that 
Element Manager. 

License keys 

The use of license keys is new for HAFM 8.x. You must enter a license key provided with your 
software and a software serial number the first time that you initialize HAFM 8.x if you are: 

• Upgrading an HAFM appliance from HAFM 7.2 to HAFM 8.x. 

• Replacing a notebook server running HAFM 7.x or 6.x with an HAFM appliance running HAFM 
8.x. 

An updated license key is supplied for optional software modules that you purchase for the HAFM 
8.x application on an HAFM appliance. To enable the new software module, you must enter this 
key into the License dialog box, which is available from the Help menu, License option in HAFM. 

Obtaining a license key 

You need to obtain a license key when upgrading software on an existing HAFM appliance to 
HAFM 8.x or when replacing a notebook server with an HAFM appliance running HAFM 8.x. 

The kit provides a software serial number on the CD jewel case and a software entitlement request 
certificate for HAFM. The certificate contains instructions to retrieve the license key from the web 
site. 

For complete instructions, refer to the HP StorageWorks HA-Fabric Manager user guide. 
Optional software modules 

If you order additional port support or software modules after your initial purchase of HAFM 8.x, 
you must perform the following procedure: 

1. When the HAFM application is running, select License from the HAFM Help menu to display the 
License dialog box. 

2. Enter the permanent key in the License Key field and click Update. 

3. Click OK. 

The software license key allows you to access HAFM and all optional software modules that you 
have purchased. Your kit documents provide a new feature enablement certificate, based on the 
number of ports that you want to support. To obtain a license key, follow instructions on the 
enablement certificate to obtain a license key. 

Feature keys 

Feature keys are unique strings of alphanumeric characters that enable the Element Manager for a 
specific switch and the additional features that you purchase for that switch. The feature key, which 
is encoded with a switch or director's serial number, can only be configured on the switch or 
director to which it is assigned. 

Here are some important notes about the Element Manager feature key for this release: 
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• There are two situations when you must contact customer support to receive an updated Element 
Manager feature key for an existing HP fabric. Note that you still are able to manage the 
product, but you receive warnings that you do not have a valid license. 

• If the director or switch was upgraded to firmware 6.0 and you reset the default settings 
through the Element Manager's Reset Configuration option. 

• If the director or switch was upgraded to 6.0 and you renter a feature key created before 
firmware 6.0 release, the Element Manager key is deleted. 

• Enabling the Reset Configuration option through the Element Manager Maintenance menu 
clears all features that were enabled through the Configure Feature Key dialog box. When you 
attempt to re-install features using a feature key assigned for version firmware 5.x, a warning 
instructs you that the Element Manager feature key is not installed. You must contact customer 
support to get a feature key reassigned. 

• As a new addition for HAFM 8.x, access to the Element Manager is provided through a feature 
key. If you do not have a feature key for an Element Manager, messages may display indicating 
this. Also, if you try to access a feature without Element Manager support, a message may 
display explaining that Element Manager support has not been installed. In these cases, you 
must contact your sales representative to obtain a feature key. 



|?f NOTE: Switches and directors on existing HP fabrics, whether running a firmware version earlier 
than 6.0 or upgraded to firmware 6.0, do not require Element Manager feature keys. 



• For directors and switches shipped with firmware 6.0 or later installed: 

• Directors— The Element Manager enablement certificate is included with the unit as shipped. 

• Switches— The Element Manager is optional. When you want to manage a switch through 
an Element Manager, you can receive an enablement certificate with which you can obtain a 
Feature Key. You must activate this key through the Configure Feature Key dialog box. 

• As you purchase additional Element Manager features, you receive a an enablement certificate 
with which you can obtain a Feature Key. 

Enabling a feature key 

To enable a feature key in the switch or director Element Manager: 

1. Select Features from the Configure menu to display the Configure Feature Key dialog box. 

2. Click New to add a new feature key. The New Feature Key dialog box displays. 

3. Enter the switch or director feature key and click OK. 
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2 Comparing HAFM 7.x and 8.x features 



This chapter compares features in HAFM 7.x and HAFM 8.x. 
This chapter includes: 

• Introduction, page 31 

• Finding 7.x features in HAFM 8.x, page 31 

Introduction 

This chapter provides a basic description of the features in HAFM 8.x that are comparable with 
features in HAFM 7.x. 

Detailed procedures for using all HAFM 8.x features, are located in the HP StorageWorks HAFM 
user guide. 

Finding 7.x features in HAFM 8.x 

Table 7 provides a quick reference for locating comparable HAFM 7.x features in HAFM 8.x. For 
specific information about using HAFM, refer to the HP StorageWorks HA-Fabric Manager user 
guide. 

Table 7 Comparing HAFM 7.x and 8.x feature locations 



Feature 


HAFM 7.x 


HAFM 8.x 




Menu > Submenu: Options 


Menu > Submenu: Options 


Identifying 


• Product > New, Delete, Modify 


• Discover > Setup 


products to 
HAFM 


Toolbar: New Product 


• Toolbar: Discover Setup 


Display product 


• Product > Properties 


• Product right-click menu > 


properties 


• Product right-click menu > 


Properties. 




Properties 


• Toolbar: Properties 


Logging out of 
HAFM 


Product > Logout 


SAN > Log Out 


Rename Fabric 


Fabrics > Rename 


Cannot rename. (Can create new 
nickname in Properties dialog box.) 


Persist Fabric 


• Fabrics > Persist Fabric Topology, 


• Configure > Persist Fabric, 




Unpersist Fabric Topology 


Unpersist Fabric 




• Toolbar: Persist Fabric Topology 


• Right-click menu on fabric in 
Physical Map or Product List > 
Persist Fabric, Unpersist Fabric 
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Table 7 Comparing HAFM 7.x and 8.x feature locations (continued) 



Feature 


HAFM 7.x 

Menu > Submenu: Options 


HAFM 8.x 

Menu > Submenu: Options 


Export Fabric 
Topoloay 


• Fabrics: Export Fabric Topology 
Toolbar: Export Fabric Topology 


• SAN > Export 

• Toolbar: Export 

(Select Product List and Physical 

k A f I - i P\ • 1 c A h. 1 

Map trom export Discovered bAN 
dialog box. 


r I i 

bhow route 


Fabrics > bhow Route/Hide Route 


/— • r. p 1 r> i 1 i i ■ 1 

Configure > bhow Koute and Hide 
Route 


c 1 

bhow zone 
members 


r~ 1 Pi ~7 k A 1 

Fabrics > bhow Zone Members 


Configure > List Zone Members 


Show magnified 
fabric view 


Fabrics > Show View Port 


View > Show All Panels (displays 
Minimap) 


Show tree 
containing fabric, 
product, device 
branches 


Fabrics > Show Fabric Tree 


View > All Panels or Fabric List 


Enterprise Fabric 
Mode (if 
enabled) 


Fabrics > Enterprise Fabric Mode 


• Configure > Enterprise Fabric 
Mode 

• Right click menu on fabric in 
Physical Map or Product List > 
Enterprise Fabric Mode 


Fabric Binding (if 
enabled) 


Fabrics > Fabric Binding 


• Configure > Fabric Binding 

• Right-click menu on fabric on 

£ 1 • • nl • i i * 

fabric in Physical Map or 
Product List > Fabric Binding 


View user HAFM 
sessions 


View > User Sessions 


SAN > Active Sessions 


Zoom out of and 
into topology 
diagram 


View > Zoom 


• View > Zoom 

Pi 1 * 1 1 k ~T 1 1 1 

• Physical Map loolbar: + and - 
icons 

• Right-click menu on empty areas 
of Physical Map 


Arrange and 
layout icons in 
topology, center 
in topology, 
refresh topology 


View > Layout Icons, Center in 
Topology, Refresh Topology 


Not available. 
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Table 7 Comparing HAFM 7.x and 8.x feature locations (continued) 



Feature 


HAFM 7.x 

Menu > Submenu: Options 


HAFM 8.x 

Menu > Submenu: Options 


Clear ISL alerts 


• View > Clear ISL Alert, Clear All 
ISL Alerts 

• Right-click menu on ISL in Fabrics 
view 

rv 1 i I- 1 f 1 

• Kight-click menu on tabric in 
Fabrics view 


Right-click connection in persisted 
fabric that displays an ISL alert and 
seieci v_iear idl /-\ien^sj. idl aien is 
a yellow triangle containing an 
exclamation mark. 


rnrin o f r 
LI lUUlu My UVcl 

display 


Viow ^> pnrih o F \/ liuor Dici"\ n\/ 
V ICW l—IILJUIt; 1 ly V./VCI L/loUIUV 


\I rnnh ^ F \//"wftr Dicr\ ln\y 
VICW LllUUIt; 1 ly^JVCI L/loUH-Jy 


t c^nfin 1 1 r"ft iicoc 
V-Ui 1 1 ly u I c Uoci 

administration 


l /~\ n fi n i \f(^ ~~*> 1 Ic^rc 
\— \J\ I 1 1 y U 1 1; Uocl o 


• 1 Iqatq 

• Toolbar: HAFM Users 


Configure user 
sessions 


Configure > Sessions 


SAN > Remote Access 


Configure 
nicknames for 
products and 
fabrics 


• Configure > Nicknames 

• Right-click menu on product in 
Fabric Tree and Fabrics view 

• Right-click menu on fabric in 
Fabrics view 


• View > Properties (when product 
selected in Physical Map or 
Product List). Enter nickname in 
Nickname field. 

• Toolbar > Properties (when 
product selected in Physical 
Map or Product List). Enter 
nickname in Nickname field. 

• Right-click menus on fabric and 
product in Physical Map and 
Product List > Properties. Enter 

nirl^nnmft in ^ irL'nn m c± fiolH 

1 1 ll_l\! IU 1 1 1 1; III 1 N |l_l\l \KJ 1 1 1 1; 1 ICIU. 


Configure SNMP 
agent 


Configure > SNMP Agent 


• Monitor > SNMP Agent (On, 
Off, Setup) 

• Monitor > Trap Forwarding 


Activate zone set 


Configure > Activate Zone Set 


• Configure > Zoning (Select 
Activate in the Zoning dialog 
box) 


Zoning library 


Configure > Zoning Library 
Toolbar: Show Zoning Library 


• Configure > Zoning 

• Right-click menu on fabric or 
proaucr in rnysicai /v\ap 

• Right-click menu on fabric or 
product in Product List 

• Toolbar: Zoning 
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Table 7 Comparing HAFM 7.x and 8.x feature locations (continued) 



Feature 


HAFM 7.x 


HAFM 8.x 




ft A f* 1 /-N 

Menu > Submenu: Options 


Menu > Submenu: Options 


Deactivate zone 
set 


Configure > Advanced Zoning > 
Deactivate Zone Set 


Configure > Zoning (Select 

r\ i* ■ 1 a ~7 I* 1 

Deactivate button on Zoning dialog 
box) 


Configure default 
zone 


Configure > Advanced Zoning > 
Configure Default Zone 


Configure > Zoning (Select Default 
Zone button on Zoning dialog box) 


Audit, Event, 
Session, Product 
Status, Fabric 
logs 


Logs > Audit, Event, Session, Product 
Status, Fabric 


Monitor > Logs > Audit, Event, 
Session, Product Status, Fabric 


Configure email 


Maintenance > Configure Email 


Monitor > Event Notification > 
Email 


Test email 
notification 


Maintenance > Test Remote 
Notification 


Monitor > Event Notification > 

r~ *l IT i i - -II ii 

Email (lest Email button on 
Configure Email dialog box) 


Configure 
Ethernet events 


Maintenance > Configure Ethernet 
Events 


Monitor > Ethernet Event 


Configure call 

hnrnp pwpnf 

1 IUI 1 IC CVCI II 

notification 


Maintenance > Configure Call Home 

l_ V C 1 1 1 1 NUIII ILUIIUI 1 


Monitor > Event Notification > Call 
Horn© 


Help 


• Help > Contents 


• Help > Contents 




• Help > About 


• Help > About HAFM 8 


Open Product 
Manager 


• Right-click menu on product icon 
(Products view) > Open 

• Toolbar: Open Product 


• Right-click menu on product icon 
(Physical Map) > Element 
Manager 

t II i Id t 

• loolbar: Launch Element 
Manager 


Delete product 
from HAFM 


Right-click menu on product icon 
(Products view) > Delete 


Right-click menu on product icon 
(Physical Map) > Delete 


Display product 
properties 


Right-click menu on product icon 
(Products view) > Properties 


Right-click menu on product icon 
(Physical Map) > Properties 

Toolbar: Properties 
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Table 7 Comparing HAFM 7.x and 8.x feature locations (continued) 



Feature 


HAFM 7.x 

Menu > Submenu: Options 


HAFM 8.x 

Menu > Submenu: Options 


Modify product 
network address 


Right-click menu on product icon 
(Products view) > Modify 


• Discover > Setup (Change 
button on Discover Setup dialog 
box) 

• View > Properties (when product 
selected in Physical Map or 
Product List). Enter nickname in 
Nickname field. 

• Toolbar: Properties (when 
product selected in Physical 
Map or Product List). Enter 
address in IP Address field. 

• Right-click menus on fabric and 
product in Physical Map and 
Product List > Properties, enter 
address in IP Address field. 


Display fabric 
properties 


Right-click menu on fabric in Fabric 
Tree and Fabrics view > Properties 


Right-click menu on fabric in Product 
List and Physical Map > Properties 


Change product 
label display 


Toolbar: pulldown list: 

• Product Name 

• Network Address 

• World Wide Name 

• Domain ID 

• Nickname 

(Changes label on Fabrics view) 


Toolbar: pulldown list: 

• Name 

• Nickname 

• Node Name 

• IP Address 

• Domain ID 

(Changes label on Physical Map 
and Product List) 
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A Configuring HAFM through a firewall 



This appendix provides optional procedures for configuring HAFM client and server applications to 
function across remote networks through a firewall. 

This chapter includes: 

• Polling client function, page 37 

• Configuring TCP port numbers to allow firewall access, page 39 



In some cases, a network may use virtual private network (VPN) or firewall technology, which can 
prohibit communication between Servers and Clients. In other words, a Client can find a Server, 
appear to log in, but immediately is logged out because the Server cannot reach the Client. To 
resolve this issue, the HAFM application is automatically detect the network configuration and run 
the Client in "polling mode" when necessary. 

When the Client is not running in polling mode, the Server calls the client whenever it has new data. 
When the Client is running in polling mode, the Server queues up the data and the Client 
periodically (approximately every 5 or 10 seconds) checks in and gets the data. Thus, the original 
two-way communication is transformed into one-way communication, allowing passage through 
firewalls. 



When a Client attempts to log into a Server, the Server normally calls back to verify communication. 
In a firewall situation, this call fails and the Server automatically treats the Client as a "polling" 
Client. It may take up to 45 seconds for this call-back to fail (worst case). You can configure a 
polling parameter in Client and Server batch files to let the Server know ahead of time that the 
Client is a "polling" Client. This skips the call-back from the Server and decreases the login time. 

Forcing a client to be polling 

To force a specific Client to be a polling Client, edit the hafm_c .bat file and the Client portion of 
the HAFM_sc .bat file, if both files are installed on your computer. These files are in the HAFM 
8 .x\bin directory (typically in c : \Program Files\HAFM 8.x\bin). 

The HAFM_sc .bat file starts both the Client and Server and is installed on a computers with the 
HAFM appliance software. The hafm_c .bat file starts the Client only and is installed with the 
Client software. 

Add the -Dsmp . callback .passive parameter as in the following example. This parameter only 
affects this client; all other clients can be regular clients. 



Polling client function 
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[if NOTE: The following example illustrates the HAFM_c .bat file. The portion of this file starting with 
rem HAFM Client is also included in the HAFM_sc .bat file. Both files must be modified if they 
are installed on your computer. 



setlocal 
pushd %~dpO\ . . 
call bin\set_cp.bat 
rem HAFM Client 

start %JAVA_HOME%\bin\HAFMClient . exe -Xmx256m -Xminf .15 -Xmaxf.35 -classpath 
%CLASSPATH%-Dsun . j ava2d . noddraw=true -Dsmp . f abricPersistenceEnabled=true 
-Dsmp .Mp.max=2 56 -Dsmp .deployment . pref ix=Client/ -Dsmp. callback. passive 
-Dsmp . f lavor=%APP_FLAVOR% Client 

rem HAFM Client Debug Mode 

rem start %JAVA_HOME%\bin\HAFMClientD . exe -Xmx256m -Xminf. 15 -Xmaxf.35 

-classpath %CLASSPATH% -Dsun. java2d.noddraw=true 

-Dsmp . f abricPersistenceEnabled=true -Dsmp . Mp .max=2 56 

-Dsun . j ava2d . noddraw=true -Dsmp . f abricPersistenceEnabled=true 

-Dsmp . deployment .pref ix=Client/ -Dsmp . debug -Dsmp. callback. passive 

?Dsmp . f lavor=%APP_FLAVOR% Client 

popd 

endlocal 

ing all clients to be polling 

To force all Clients communicating with a Server to be treated as polling clients (regardless of the 
parameters the Clients launch with), edit the HAFM_sc .bat file located in the HAFM 8 .x\bin 
directory (typically in c : \Program FilesVHAFM 8 . x\bin). Add the 

-Dsmp . callback. passive parameter to the HAFM Server section of the file as in the following 
example. 

setlocal 
pushd %~dpO\ . . 
call bin\set_cp.bat 



rem HAFM Server 

start %JAVA_HOME%\bin\HAFMServer . exe -server -Xm512m 
-Xminf. 15 -Xmaxf.3 5 -classpath %CLASSPATH% 
-Dsmp . Mp .max=512 -Dsmp . autodiscovery= false 
-Dsmp .mpi . test -Dsmp . deployment . pref ix=Server/ 
-Dsmp . zoning=legacy 

-Dsmp . zoning .wait . timeout=180000 -Dsmp . webserver -Dsmp. callback. passive 

-Dsmp . f lavor=%APP_FLAVOR% Server 

rem HAFM Server Debug Mode 

rem start %JAVA_HOME%\bin\HAFMServerD . exe -server 
-Xmx512m -Xminf. 15 -Xmaxf.35 -classpath 
%CLASSPATH% -Dsun. java2d.noddraw=true -Dsmp .Mp . max=512 
-Dsmp . autodiscovery=f alse 

-Dsmp .mpi . test -Dsmp . deployment . pref ix=Server/ 
-Dsmp . zoning=legacy 

-Dsmp . zoning . wait . timeout=180000 -Dsmp . debug 
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-Dsmp .webserver -Dsmp. callback. passive 

-Dsmp . f lavor=%APP_FLAVOR% Server 



: end 
popd 
endlocal 

Configuring TCP port numbers to allow firewall access 

This section provides details about configuring TCP port numbers for RMI Servers and Registries to 
allow HAFM Client and Server application to function across firewalls. 

HAFM function with RMI at TCP port level 

The RMI protocol lies between the HAFM application and the TCP/IP layer, as shown in the 
following table. 



Table 8 RMI protocol level 



HAFM appliance 


HAFM client 


RMI 


RMI 


TCP/IP 


TCP/IP 



As shown in Figure 3, the HAFM appliance and Clients communicate with each other through the 
RMI Server. This is a full-duplex function. However, before the RMI Server on the HAFM Client can 
communicate with the RMI Server on the HAFM appliance, it must know the TCP port number of the 
RMI Server. The function of the RMI registry is to communicate this TCP port number to the HAFM 
Client. Once this is done successfully, communication can take place between the RMI Server on the 
HAFM appliance and the HAFM Client. (The HAFM appliance obtains the TCP port number of the 
RMI Server on the Client during initial communications.) 



HAFM appliance 




HAFM client 


RMI Server RMI Registry 


RMI Server RMI Registry 




k 




t 




i 


i 


RMI Servers's TCP/IP port # 




i 




RMI Servers's TCP/IP port # 






Full Duplex Communication 





Figure 3 HAFM appliance and client communications 

The TCP port numbers of the RMI server are randomly and automatically selected on both the HAFM 
appliance and Client as a full-duplex function. This poses a major problem for firewalls because 
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they need to know which TCP port numbers to pass through and which numbers to block. Firewalls 
are configured to block all unknown incoming connections with no mapping of outgoing 
connections based on a socket part of TCP and IP. 

To work around this problem, administrators can "predict" which ports are used by the Client and 
Server by configuring these port numbers into appropriate batch files. Using the following 
procedures depends on how the firewall is set up. Afterward you configure TCP port numbers in the 
following procedures, the firewall must be configured to unblock the configured port numbers. 

If the firewall prevents the client from connecting to arbitrary ports on the server, then perform 
both of these procedures: 

• "Forcing port in RMI registry" on page 40. 

• "Forcing server and client export port number" on page 41 . 



|?f NOTE: You must configure both the Server and Client export port numbers. 



If the firewall prevents the server from connecting to arbitrary ports on the client, then configure 
the export port of the client in "Forcing server and client export port number" on page 41 . 



[if NOTE: If the firewall prevents the server from connecting to arbitrary ports on the client, then just 
configure the export port of the client (-Dsmp . client . export .port=xxxx) . 



Forcing port in RMI registry 

To force the RMI registry to use a particular TCP port for an RMI server, configure the 

Dsmp. regis try. port=xxxx parameter in the HAFM_sc.bat file. This file starts both the Client 

and Server and is installed on a computers with the HAFM appliance software. The file is typically 

located in c : \Program Files\HAFM 8 . x\bin. Both the Client and Server areas of the 

HAFM_sc .bat file must have matching parameters. Add a matching parameter to the 

HAFM_c .bat file if, this is installed on your computer. This file starts the Client only and is installed 

with the Client software. 

HAFM_sc.bat file 

Edit the HAFM_sc.bat file in the HAFM Server and HAFM Client area to include the parameter 
-Dsmp. registry. port=XXXX, where XXXXts any TCP port number not being used by another 
application. You must place this parameter after the %classpath% parameter as in the following 
example. 

setlocal 

pushd %~dpO\ . . 

call bin\set_cp.bat 



rem HAFM Server 

start %JAVA_HOME%\bin\HAFMServer . exe -server -Xmx512m -Xminf.15 -Xmaxf.35 
-classpath %CLASSPATH% -Dsmp .Mp .max=512 -Dsmp . autodiscovery=f alse 
-Dsmp .mpi .test -Dsmp . deployment . pref ix= Server / -Dsmp . zoning= legacy 
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-Dsmp . zoning .wait . timeout=180000 -Dsmp . webserver -Dsmp . registry .port =XXXX 

-Dsmp . f lavor=%APP_FLAVOR% Server 
rem HAFM Server Debug Mode 

rem start %JAVA_HOME%\bin\HAFMServerD . exe -server -Xmx512m -Xminf.15 
-Xmaxf.3 5 -classpath %CLASSPATH% 

-Dsmp.Mp.max=512 -Dsmp . autodiscovery=f alse -Dsmp .mpi . test 
-Dsmp . deployment . pref ix=Server / -Dsmp . zoning=legacy 
-Dsmp . zoning .wait . timeout=180000 -Dsmp. debug -Dsmp . webserver 
-Dsmp. registry. port=XXXX -Dsmp . f lavor=%APP_FLAVOR% Server 

: client 

rem HAFM Client 

start %JAVA_HOME%\bin\HAFMClient . exe -Xmx256m -Xminf.15 -Xmaxf.35 -classpath 
%CLASSPATH% -Dsun . java2d . noddraw=true -Dsmp . f abricPersistenceEnabled=true 
-Dsmp . Mp . max=2 56 -Dsmp . deployment . pref ix=Client / -Dsmp. registry . port=XXXX 
?Dsmp . f lavor=%APP_FLAVOR% Client 

rem HAFM Client Debug Mode 

rem start %JAVA_HOME%\bin\HAFMClientD . exe -Xmx256m -Xminf.15 -Xmaxf.35 
-classpath %CLASSPATH% -Dsun. java2d.noddraw=true 
-Dsmp . f abricPersistenceEnabled=true -Dsmp . Mp .max=2 56 

-Dsmp . deployment . pref ix=Client / -Dsmp . debug -Dsmp . registry .port =XXXX 

?Dsmp . f lavor=%APP_FLAVOR% Client 

: end 

popd 
endlocal 

HAFM_c.bat file 

setlocal 
pushd %~dpO\ . . 

call bin\set_cp.bat 



rem HAFM Client 

start %JAVA_HOME%\bin\HAFMClient . exe -Xmx256m -Xminf.15 -Xmaxf.35 -classpath 
%CLASSPATH% -Dsun . java2d . noddraw=true -Dsmp . fabric Per sis tenceEnabled= true 
-Dsmp .Mp .max=2 56 -Dsmp . deployment .pref ix=Client/ -Dsmp . f lavor=%APP_FLAVOR% 
Client 



rem HAFM Client Debug Mode 

rem start %JAVA_HOME%\bin\HAFMClientD . exe -Xmx256m -Xminf.15 -Xmaxf.35 
-classpath %CLASSPATH% -Dsun . j ava2d . noddraw=true 
-Dsmp . f abricPersistenceEnabled=true -Dsmp . Mp .max=2 56 

-Dsmp . deployment .pref ix=Client/ -Dsmp . debug -Dsmp . registry . port=XXXX 

-Dsmp . f lavor=%APP_FLAVOR% Client 

Forcing server and client export port number 

To force the Server and Client to export a specific TCP port number for an RMI server, configure the 

-Dsmp . server . export . port=XXXX and -Dsmp . client . export . port=XXXX 
parameters in HAFM_sc.bat and the -Dsmp. client, export. port=xxxx in the HAFM_c.bat 
file. These files are typically located in c : \Program Files\HAFM 8 .x\bin. 
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[if NOTE: If the firewall prevents the server from connecting to arbitrary ports on the client, then just 
force the export port of the client (-Dsmp . client . export .port=XXXX). 



The HAFM_c .bat file starts both the Client and Server and is installed on a computers with the 
HAFM appliance software. The file is typically located in c : \Program Files\HAFM 8 .x\bin. 
Both the Client and Server areas of the HAFM_sc.bat file must have matching parameters. Add a 
matching parameter to the HAFM_c .bat file if, this is installed on your computer. This file starts the 
Client only and is installed with the Client software. 

HAFM_sc.bat file 

Edit the HAFM_sc.bat file in the HAFM Server area to include the parameter 
-Dsmp . server . export . port=XXXX and the HAFM Client area to include the parameter 
-Dsmp . client . export .port = YYYY, where xxxx and YYYY are any TCP port numbers not 
being used by another application. Although the server port number xxxx could match the client 
port number YYYY, this is not necessary. If the HAFM_c .bat file is installed on your computer, add 
the -Dsmp . client . export .port=YYYY parameter to that file. Add these parameters after the 
%CLASSPATH% parameter as in the following example. 

setlocal 
pushd %~dpO\ . . 
call bin\set_cp.bat 



rem HAFM Server 

start %JAVA_HOME%\bin\HAFMServer . exe -server -Xmx512m -Xminf.15 -Xmaxf.35 

-classpath %CLASSPATH% -Dsmp .Mp .max=512 -Dsmp . autodiscovery=f alse 

-Dsmp .mpi .test -Dsmp . deployment . pref ix= Server / -Dsmp . zoning= legacy 

-Dsmp . zoning .wait . timeout=180000 -Dsmp . webserver 

-Dsmp. server. export. port=XXXX -Dsmp . f lavor=%APP_FLAVOR% Server 

rem HAFM Server Debug Mode 

rem start %JAVA_HOME%\bin\HAFMServerD . exe -server -Xmx512m -Xminf.15 
-Xmaxf.35 -classpath %CLASSPATH% -Dsmp .Mp . max=512 -Dsmp . autodiscovery=f alse 
-Dsmp .mpi .test -Dsmp . deployment . pref ix= Server / -Dsmp . zoning= legacy 
-Dsmp . zoning .wait . timeout=180000 -Dsmp. debug -Dsmp . webserver 
-Dsmp. server. export. port=XXXX -Dsmp . f lavor=%APP_FLAVOR% Server 

: client 

rem HAFM Client 

start %JAVA_HOME%\bin\HAFMClient . exe -Xmx256m -Xminf.15 -Xmaxf.35 -classpath 
%CLASSPATH% -Dsun. java2d.noddraw=true -Dsmp. f abricPersistenceEnabled=true 
-Dsmp . Mp . max=2 56 -Dsmp . deployment . pref ix=Client / 
-Dsmp. client. export. port =YYYY ?Dsmp . f lavor=%APP_FLAVOR% Client 

rem HAFM Client Debug Mode 

rem start %JAVA_HOME%\bin\HAFMClientD . exe -Xmx256m -Xminf.15 -Xmaxf.35 
-classpath %CLASSPATH% -Dsun. java2d.noddraw=true 
-Dsmp . f abricPersistenceEnabled=true -Dsmp . Mp .max=2 56 

-Dsmp . deployment . pref ix=Client / -Dsmp . debug -Dsmp . client . export .port = YYYY 

?Dsmp . f lavor=%APP_FLAVOR% Client 

: end 
popd 
endlocal 
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HAFM_c.bat file 

setlocal 
pushd %~dpO\ . . 

call bin\set_cp.bat 



rem HAFM Client 

start %JAVA_HOME%\bin\HAFMClient . exe -Xmx256m -Xminf .15 -Xmaxf .35 -classpath 
%CLASSPATH% -Dsun . java2d . noddraw=true -Dsmp . f abricPersistenceEnabled=true 
-Dsmp . Mp . max=2 5 6 -Dsmp . deployment . pref ix=Cl ient / -Dsmp . f lavor=%APP_FLAVOR% 
Client 



rem HAFM Client Debug Mode 

rem start %JAVA_HOME%\bin\HAFMClientD . exe -Xmx256m -Xminf. 15 -Xmaxf. 35 
-classpath %CLASSPATH% -Dsun . j ava2d . noddraw=true 
-Dsmp . f abricPersistenceEnabled=true -Dsmp . Mp .max=2 56 

-Dsmp . deployment . pref ix=Cl ient / -Dsmp . debug -Dsmp . client . export .port =YYYY 

-Dsmp . f lavor=%APP_FLAVOR% Client 

popd 
endlocal 
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